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Appendix A 
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Exclusion Export 
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Main Script: 
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Name 
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exclude_export script 
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Command Line Parameters 
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None 
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Exit Parameters 
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0 on Success 
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-1 on Failure 
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Input Files 
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None 
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Input Tables 
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Control Table (see Database Table Schema Spec) 
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Output Files 
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None 
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Output Tables 
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None 
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Temporary Files 
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None. 
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Temporary Tables 
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None 
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Other Outputs 
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System Messages : The $TRS/bin/logm program will 
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used to log actions to System Messages. 
Variables 

Tables Array : array of exclusion tables to be 
exported 

LastRecNum : integer : holds, the value from the 
last_copied_num field of the Control Table- for the current 
exclusion table. 

LastDate : character string : holds the value from 
the last_copied_date field of the Control Table for the 
current exclusion table. 

Process Flow 

Write ''Exclusion Export Started" to System Messages 
Read Control Table to get list of exclusion tables 
that need to.be copied to other dialers. Place the list, into 
the Tables Array 

For each table in Tables Array 

Fill the LastRecNum and LastDate fields from the 
Control Table for the current table. 

Write ''Exporting <current table in Tables Array>" 
to. System Messages 

If a record exists in the table with a RECNUM of 
LastRecNum and a date of LastDate then 

Execute the Export Script passing the name of 
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the current table in the Tables Array and LastRecNum as 
parameters 

else 

Execute the Export Script passing the name of 
the current table in the tables Array and zero (0) as 
parameters 

After all tables have been exported write ''Exports 
finished, copying to remote dialers" to System Messages 
Run the FTP script. 

Write ''Exclusion Export Finished" to System Messages 

Export Script : 

Name 

exclude_export_table_script 
Command Line Parameters 

Exclusion Table Name : character : Name of table in 
ccr database to be copied to file. 

Will be of format "exc_<APPLICATION NAME>_<FIELD 
NAME>" (e.g. exc_TRACKER_ACCOUNT_NUM) 

LastRecordNumber : integer : stores the record number 
of the last record that was copied 
Exit Parameters 
0 on Success 
-1 on Failure 
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Input Files 

?? : The site ID needs to be read from the system 
info file, or where ever else it can be gotten from. 
Input Tables 

Exclusion Table Name table : This, table will be the 
source of the records that will be added to the Export File. 
Output Files 

Export File : ASCII : File which contains the newest 
exclusion records that were added to the Exclusion Table 
specified in the Exclusion Table Name command line parameter , 

Details: 

The file will be named 

exc_<ThisSiteID>_<Exclusion Table Name>_<MMDDHHMM> , txt . 

This file will be placed in the 
$RCS/exclude_export directory. 

Header Record of format "-HEADER ApplicationName 
FieldName" where the Application Name and Field Name are 
extracted from the Exclusion Table Name command line 
parameter . 

The values from the FieldName column of the 
Exclusion Table Name table will be placed one record per line 
in the rest of the file. 
Output Tables 

Control Table : The Last Copied Number and Last 
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Copied Date fields will be updated with the values from the 
Record Number field and Date field of the last record to be 
placed into the Export File. 
Temporary Files 
None 

Temporary Tables 

Exclusion Export Temp Table : netexc_temp : This 
table will be used to extract the records from the Exclusion 
Table Name table before copying to the Export File. 

Other Outputs 

System Messages : The $TRS/bin/logm program will be 
used to log actions to System Messages. 
Variables 
None 

Process Flow 

Clear the temporary table named netexc_temp 

Insert records from <Exclusion Table Name> table with 

Record Number greater than LastRecordNumber and status not 

equal to 99 into the temp table. 

Copy the records from the temp table to the Export 

File. 



FTP Script: 



1 Name 

2 exclude_export_f tp_script 

3 Command Line Parameters : 

4 None 

5 Exit Parameters 

6 0 on Success 

7 -1 on Failure 

8 Input Files 

9 All files in the $RCS/exclude_export directory. 

10 Input Tables 

P ' . ■ 

Q 11 Dialer Control Table (see Database Schema Spec) : The 

■Q 12 list of dialers will be used to determine to which dialers 

ru 13 the Input Files should be sent. 

rO 

ry 14 Output Files 

15 All Input Files will be copied to other dialers , 

K 16 Output Tables 

Q 17 Dialer Control Table : The Last Sent field will be 

S.J 

18 updated with the current date for each dialer that is sent 

19 the Input Files. 

20 Temporary Files 

21 temp_exclude_f tp. scr : ASCII : This file will be 

22 rebuilt for each dialer that should receive the Input Files 

23 and passed to the FTP program for execution. 

24 Temporary Tables 
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# # 



1 None 

2 Other Outputs 

3 System Messages : The $TRS/bin/logm program will be 

4 used to log actions to System Messages. 

5 Variables 

6 IPAdds array : character : holds the IP addresses of 

7 the remote dialers. 
8 

9 Process Flow 

10 Add the IP Addresses from the Dialer Control Table to 

5 11 the IPAdds array. 

2 12 For each IP Address in the IPAdds array 

13 Create a new Temporary File 

14 Add an open statement with the current IP Address 

15 from the IPAdds array to the Temporary File 
Li, 16 Add a login id and a password 

17 Add a statement to turn off prompting- 
Add an input statement to put all of the Input 

19 Files in the $RCS/exclude_f iles directory on the remote 

20 dialer. 

"21 Add a close statement. 

22 Run the FTP program passing the name of the 

23 temporary file as the script parameter 

24 Update the Dialer Control Table Last Sent field 
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1 with the current date • for the current dialer 

2 

3 Exclusion In^ort 

4 Search Script: 

5 Name 

6 down_user_exclusion 

7 Command Line Parameters 

8 None 

9 Exit Parameters 
10 0 on Success 

=1 11 -1 on Failure 

^3 i2 Input Files 

|y.l3 All files in the $RCS/exclude_f lies 

fU 14 Input Tables 

O 15 None 

U 16 Output Files 
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Q 17 Files in $RCS/exclude_f iles will be copied to 

18 down.X. <date> one at a time 

19 Output Tables 

20 None 

21 Temporary Files 

22 None 

23 Temporary Tables 

24 None 
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other Outputs 

System Messages : The $TRS/bin/logm program will be 
used to log actions to System Messages. 
Variables 

Files array : character : This array will hold the 
names of the Input Files. 

Process Flow 

Fill the Files array with the names of the Input 

Files. 

For each file in the Files array 
Get the size of the file 
Wait 15 seconds 

If the file size changes skip this file and try 
it again after checking the other files. 

If the file size didn't change 

Copy the file to the Output File 
Run the Import Script passing the Output File 
n ame as a par ame t e r 

Import Script; 

Name 

down_exclusiori_script 
Command Line Parameters 
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Input File Name : character : This will hold the name 
of the file that should be imported. 
Exit Parameters 

0 on Success 

-1 on Failure 
Input Files 

The Input File Name passed as a command line 
parameter . 

Will have a header formatted like: "'-HEADER 
<APPLICATION NAMEXFIELD NAiyiE>" 

Each line after the header will have a .value that 
should be placed in the Field Name field of the Output Table, 
one per record. 
Input. Tables 

None 
Output Files 

None 
Output Tables 

The exclusion table, exc_<APPLICATION NAME >_< FX ELD 
NAME> specified in the header of the Input File. 
Temporary Files 
None 

Temporary Tables 

tmp_<APPLICATION NAME>_<FIELD NAiyiE> : This will be 
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created from the header of the Input File. See the Database 
Table Schema Spec for more details. 
Other Outputs 

System Messages : The $TRS/bin/logm program will be 
used to log actions to System Messages. 
Variables 

AppName : character : Will store the name of the 
application determined from the header of the Input File 

FieldName : character : Will store the name of the 
field determined from the header of the Input File 

Process Flow 

Read Header of Input File and place Application Name 
is AppName and Field Name in FieldName. 
Create the temporary table. 

Copy the data from the Input File into the Temporary 

Table. 

Insert the data from the Temporary Table into the 
Output Table. Set the status field for inserted records to 
99. 

Notify the Unison system that the exclusion tables 
have changed. 
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